home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Diamond Collection / The Diamond Collection (Software Vault)(Digital Impact).ISO / cdr13 / fa_edit.zip / FA-EDIT.DOC < prev    next >
Text File  |  1995-01-01  |  16KB  |  356 lines
  1.                             First ADE SoftWear
  2.                             Allen D. Evans
  3.                             Box 107
  4.                             Frankfort, Ohio 45628
  5.                             U.S.A.
  6.  
  7.                             (049) 06371-43384
  8.  
  9. Foreword
  10. ════════
  11.         First The Legal Stuff
  12.         ═════════════════════
  13.         Use of a trademark or service mark in this file should not be
  14.         regarded as affecting its validity.
  15.  
  16.     I decided to write my own word processor/text editor in late 1993.  A
  17. computational program I use daily produces files averaging 50,000 to 200,000
  18. bytes (i.e., characters) in size.  These files can exceed 500,000 bytes and,
  19. on occasion, grow to 2 or 3 megabytes (2,000,000 to 3,000,000 characters).
  20. Creating and proofing a document so large requires creating and proofing
  21. numerous subunits and then using the
  22.     "COPY file1 + file2 + file3 + file4 enddoc.txt"
  23. technique to produce the end product.  This is cumbersome, time consuming,
  24. and error prone.
  25.  
  26.     Making matters worse, high-end word processors capable of handling
  27. these large programs have the bad habit of corrupting the formatting.
  28. Microsoft's Edit, which is otherwise perfect, dies after approximately
  29. 128,000  bytes, and Edlin, which handles large files surprisingly well by
  30. swapping pages into and out of memory, just isn't friendly enough.
  31.  
  32.     So, necessity being the mother of invention, First ADE Edit was born.
  33. Version 1.0 , a 64kB editor, is more complete than Microsoft's Edit included
  34. in MSDOS version 5/6.xx.  First ADE Edit version 1.0 can't read 3 megabyte
  35. files (yet) but it can open multiple files at once (approximately seven
  36. 50,000 byte files at a time) and write out to 256 columns.  If requested,
  37. First ADE Edit can be produced to write out to 1024 or more columns.  See
  38. the table below for a comprehensive list of First ADE Edit's abilities.
  39.  
  40. Options                                    First ADE Edit  │    MS Edit
  41. ───────────────────────────────────────────────────────────┼────────────────
  42. Read files larger than 1 megabyte                 No       │      No
  43.                                                            │
  44. Work with numerous files at once                 Yes       │      No
  45.                                                            │
  46. Ability to Zoom, Size, Tile, and Cascade windows Yes       │      No
  47.                                                            │
  48. Max number of columns                            256       │     256
  49.                                                            │
  50. Print                                        Yes - limited │     Yes
  51.                                                            │
  52. Ability to shell to DOS                          Yes       │      No
  53.                                                            │
  54. Undo command to remove mistakes                  Yes       │      No
  55.                                                            │
  56. Editable Clipboard - make changes to items                 │
  57.    before pasting into your document             Yes       │      No
  58.                                                            │
  59. Search ability, once or multiple times           Yes       │     Yes
  60.                                                            │
  61. Search and Replace                               Yes       │     Yes
  62.                                                            │
  63. Tools such as: (courtesy Borland, Inc.)                    │
  64.    ASCII Table                                   Yes       │      No
  65.    Four Function Calculator                      Yes       │      No
  66.    Monthly Calendar (1776 'til 3000, at least)   Yes       │      No
  67.    Sliding Block Puzzle (just for fun)           Yes       │      No
  68.    Clock                                         Yes       │      No
  69.                                                            │
  70. Working Hot Keys on status line                  Yes       │      No
  71.                                                            │
  72. Multi-lingual editions (all in one program)      Yes       │      No
  73.                                                            │
  74. Works on ANY computer with ANY version of DOS    Yes       │      No
  75.  
  76.     Several major, and a few minor, improvements are planned to Edit.
  77. Toggle-able word wrap is planned for the near term.
  78.  
  79.     Edit will remain an ASCII only text editor.  The next task at hand
  80. is Word.  Word will be a superset of Edit, with text formatting capabilities,
  81. e.g., left/center/right justification, headers and footers, underline, bold,
  82. single and double spaced text, etc.
  83.  
  84.     If Edit and Word prove successful Works will follow.  Works will
  85. contain a word processor, database, spreadsheet, and maybe graphics and
  86. communications.  In short, it will be a complete integrated environment.
  87. I plan to include similar features as those currently found in other "Works"
  88. programs.  Works may debut in 1996 - plenty of things will keep me busy 'til
  89. then.
  90.  
  91. Getting Started
  92. ═══════════════
  93.  
  94.    Installation
  95.    ────────────
  96.    Installation can be accomplished manually or with the included program,
  97.    INSTALL.BAT.
  98.  
  99.    Manual Installation
  100.    ───────────────────
  101.    Decide where to store Edit, perhaps in C:\EDIT
  102.    ─> For example, to create C:\EDIT type: MD C:\EDIT and copy the
  103.       contents to that directory.
  104.    ─> Or copy the diskette's contents to an existing directory of your
  105.       choice, like C:\DOS.
  106.  
  107.    Update your PATH, if necessary.  PATH, found in the AUTOEXEC.BAT file
  108.    enables your computer to execute First ADE Edit easily.
  109.  
  110.    Automated Installation
  111.    ──────────────────────
  112.    Decide where to store Edit.  Like the above example, perhaps in C:\EDIT.
  113.    To install Edit type: INSTALL C:\EDIT.
  114.    ─> The program will create the directory, copy Edit into it, and,
  115.       optionally, update your path, which the computer searches to find Edit.
  116.    ─> The install file makes a grand attempt to update the PATH.  In case
  117.       things don't work, which they may not if you load Microsoft Windows or
  118.       a DOS Shell from the AUTOEXEC.BAT, you can update the PATH yourself.
  119.       With First ADE's Edit (of course) add a semi-colon and the new
  120.       directory name (e.g., C:\EDIT) to the end of the PATH statement.
  121.  
  122.       For example: PATH=C:\;C:\DOS;C:\WINDOWS;C:\Edit
  123.                                              ^^^^^^^^
  124.                                              CHARACTERS ADDED
  125.  
  126.    After Edit is installed per the instructions, simply type: FAE
  127.    (First Aid Edit) anywhere in the computer to enjoy your new text editor.
  128.  
  129. Starting First ADE Edit
  130. ═══════════════════════
  131.     DOS is not case sensitive.  To DOS edit looks the same as EDIT, the
  132. same applies to c:\windows\win.ini and C:\WINDOWS\WIN.INI.  Typing any
  133. combination of these upper and lower case characters will obtain the desired
  134. results.  Edit is started by typing the command FAE plus any command-line
  135. parameters.  
  136.  
  137.    ─> An example would be: FAE autoexec.bat config.sys.
  138.  
  139.     Files from anywhere on the computer can be started by adding the
  140. file's complete path.  For example, if you are in the C:\UTILITY directory
  141. and the PATH contained the directory where Edit is located, then:
  142.  
  143.    ─> FAE c:\windows\win.ini c:\windows\system\sys.ini c:\ndos.ini
  144.  
  145. would start Edit and open those three files.  The last file, in this case
  146. C:\NDOS.INI, is left on top to show how many files Edit was able to load
  147. into memory.
  148.  
  149. Keyboard and Mouse Conventions
  150. ══════════════════════════════
  151.    ─> Alt─1, means to press and hold down the Alt key and then press the 1
  152.       key.  After doing this a window with that number (see the upper right
  153.       hand corner of the window containing this text for an example), if it
  154.       exists, will be brought to the front for editing.
  155.  
  156.    ─> Alt─F, is similar to the Alt─1 explained above.  Alt─letter
  157.       combinations in Edit act on menus.  Typing Alt─F in the English menu
  158.       system opens the File menu, typing N would then open a blank screen to
  159.       start a new document.  The same command can be written as: Alt─F, N.
  160.  
  161.    ─> F2, and Shift─ and Alt─ variations of the function keys (often called
  162.       Hotkeys), perform actions on a global basis in Edit.  These options are
  163.       listed in the menus beside other commands.  Pressing F2 will
  164.       immediately start the File Open dialog.  Alt─F2 will save the current
  165.       document, etc.  See the menu to find out which function keys/Hotkeys
  166.       are assigned to which actions.
  167.  
  168.       The function keys/Hotkeys in Edit are more logically arranged than any
  169.       other word processor I've yet seen.  Per computer standards, F1, and
  170.       its variations, are assigned to the Help function.  Except for the
  171.       Options Menu, each menu is assigned its own function key, they are
  172.       overviewed below:
  173.  
  174.                     Associated Function Key
  175.     Menu     │  or Hot Key
  176.         ─────────┼─────────────────────────
  177.         File     │  F2
  178.         Edit     │  F3
  179.         Search   │  F4
  180.         Format*  │  F5
  181.         Options**│  F6
  182.         Window   │  F7
  183.         Help     │  F1
  184.  
  185.       * Menu not implemented in Edit, function key is reserved for upcoming
  186.       release of Word.
  187.       ** Function key not applicable to types of commands available, function
  188.       key is reserved to maintain consistency.
  189.  
  190.    ─> Alt─X, (eXit) is a global command which will exit from Edit, prompting
  191.       you to save documents, if necessary.
  192.  
  193.    ─> Clicking with the mouse is accomplished by positioning the mouse cursor
  194.       over an item and pressing the left mouse button once.
  195.  
  196.    ─> Dragging with the mouse is accomplished by positioning the mouse cursor
  197.       over an object; pressing and holding the left mouse button down, moving
  198.       the mouse to the new position; and releasing the left mouse button.
  199.  
  200. First ADE's Pieces and Parts
  201. ════════════════════════════
  202.     Edit's screen has more operationally active surfaces than you might
  203. initially realize.
  204.  
  205.    Three areas are most obvious.
  206.    ─> The Menu Line
  207.       ═════════════
  208.       The Menu Line sits at the top of the screen.  It holds the Menu Items
  209.       which access Edit's many options.
  210.  
  211.       You select the Menu Items by clicking on them with a mouse or using
  212.       the Alt─letter combination described above.
  213.  
  214.    ─> The Desktop
  215.       ═══════════
  216.       The Desktop occupies the middle of the screen.  The windows holding the
  217.       documents occupy this space.  Numerous surfaces are available here.  If
  218.       selectable, the surfaces here are available only with a mouse.
  219.       However, the same effects are possible with the keyboard.
  220.  
  221.       (LEGEND: Button Name; Menu Combination; Hotkey)
  222.       [_] Close Window Button; Alt─F, C; F─2
  223.       ──────────────────────────────────────
  224.       Pressing this button closes the window.  If the document has been
  225.       modified you are prompted to save it.
  226.  
  227.       Title
  228.       ─────
  229.       You can not modify the Title unless you save the document with a
  230.       different name.  A new document's Title states Untitled.  To move a
  231.       document's window, click on the title and drag the window to its new
  232.       position.
  233.  
  234.       Window Number; Alt─W, N; F7
  235.       ───────────────────────────
  236.       The Window Number is the number used with the Alt─number combination
  237.       described above.
  238.  
  239.       [Double Arrow] Zoom Button; Alt─W, Z; Alt─F7
  240.       ────────────────────────────────────────────
  241.       This button will toggle between a maximized and reduced window size.
  242.       Each window in Edit starts maximized, you would need to resize the
  243.       window before this button is active, because the maximized and reduced
  244.       size are initially equal.
  245.  
  246.       Vertical and Horizontal Scroll Bars; Page Up, Page Down, Home, End
  247.       ──────────────────────────────────────────────────────────────────
  248.       The Scroll Bars move you quickly through the document and show your
  249.       position in the document relative to the entire document.  Clicking and
  250.       dragging the button found between the two arrows will speed you through
  251.       the entire document.  The same overall actions are possible with the
  252.       four keyboard keys listed above.
  253.  
  254.       Modification Indicator (Snowflake)
  255.       ──────────────────────────────────
  256.       This symbol, found in the lower left corner, indicates if a document
  257.       has been modified in any way since being opened.  Saving the document
  258.       will remove the Snowflake symbol.
  259.  
  260.       X:Y Position Indicator
  261.       ──────────────────────
  262.       The current cursor position is reflected in these two coordinates.  The
  263.       origin is the document's uppermost top left corner.
  264.  
  265.       ─┘ Sizing Handle; Alt─W, S; Ctrl─F7
  266.       ───────────────────────────────────
  267.       Clicking on and dragging this symbol will resize the window in two
  268.       dimensions.  After resizing a window, Zooming it by any method becomes
  269.       possible.
  270.  
  271.    ─> The Status Line
  272.       ═══════════════
  273.       The Status Line sits at the bottom of the screen.  It holds the Status
  274.       Line Items listing a few of Edit's options and provides Hints to Menu
  275.       Line Items.
  276.  
  277.       You select the Status Line Items by clicking on them with a mouse, or
  278.       using the Hotkey combinations listed.
  279.  
  280. Navigating in First ADE Edit
  281. ════════════════════════════
  282.     From the example in "Starting First ADE Edit" above, you can switch
  283. to WIN.INI by typing Alt─1.  This brings the first window opened to the front
  284. of the screen.  SYS.INI is accessed by typing Alt─2, and NDOS.INI is brought 
  285. back to the front by typing Alt─3.  Repeatedly pressing F7 accomplishes the
  286. task, too.  Window Menu options allow you to resize and move the windows to
  287. have multiple documents visible simultaneously.  If two or more windows are
  288. visible you can also click on the one you want to make it the active window.
  289.  
  290. Registering First ADE Edit
  291. ══════════════════════════
  292.     First ADE Edit is being distributed as Shareware.  It is not a free
  293. program.  If you use Edit for more than 30 days, you should register it by
  294. sending $5, or an equivalent amount in your local currency, to register the
  295. product.  A good indicator if you should register a program is this rule of
  296. thumb:  If you need to accomplish a task and you immediately think of
  297. Shareware product, then you should register that product.
  298.  
  299.     $5 isn't expensive.  Edit is priced to encourage registration.
  300. The money goes to purchase manuals and compilers to increase my abilities to
  301. produce better software.  Also, I'm curious to know how widely distributed
  302. Edit is.
  303.  
  304.     If you want an updated edition of the Edit, the price is $15.
  305. The price covers the updated software registration, the diskette and mailer,
  306. and postage.
  307.  
  308. Use this form when registering or ordering First ADE Edit.
  309.  
  310. Name:____________________________________________
  311.  
  312. Address:_________________________________________
  313.  
  314. Address:_________________________________________
  315.  
  316. Address:_________________________________________
  317.  
  318. Address:_________________________________________
  319.  
  320. Internet Address:________________________________
  321.  
  322.  
  323. Action:
  324. ═══════
  325. Partial Registeration   __ $5.00 (or equivalent)
  326. ──> Registers current copy of First ADE Edit.  Also, places you on mailing
  327. list for new versions.
  328.  
  329. Full Registration:      __ $15.00 (or equivalent)
  330. ──> Provides a copy of the current registered version of Edit via diskette
  331. and a printed copy of the User's Manual, entitles you to a free major
  332. software update when available, places you on the mailing list for other
  333. 'breaking' information.
  334.  
  335.  
  336. Diskette Size:
  337. ══════════════
  338. Diskette Size Desired:    __ 5.25"
  339.             __ 3.5"
  340.  
  341.  
  342. Misc. Information (if known):
  343. ═════════════════════════════
  344. (type VER at command line)
  345. DOS Version:        _____      __ Huh?
  346.  
  347. Windows:        __ Y __ N  __ Huh?    Version: _____
  348.  
  349. (use CPU-NDP.COM utility provided)
  350. CPU Type:        _____ (8088, 8086, 286, 386, 486, or 586)
  351. FPU:            __ Y  __ N  __ Huh?
  352.  
  353. (try typing MEM at command line)
  354. Extended Memory:    __ Y  __ N  __ Huh?    Amount: _____
  355.  
  356. Expanded Memory:    __ Y  __ N  __ Huh?    Amount: _____